DisplayFrameClosed

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

DisplayFrameClosed
The DisplayFrameClosed method is called to notify this part that one of its display frames has been closed.
void DisplayFrameClosed (in ODFrame frame);
frame
A reference to a display frame to be closed.

DISCUSSION
OpenDoc calls this method when this part's document or window closes.
Your part's DisplayFrameClosed method should update your part's internal list of display frames and other related structures to reflect the removal of the specified display frame from memory, and it should close any embedded frames. In addition, your method should call the arbitrator's RelinquishFocusSet method to relinquish any foci owned by the display frame being closed.
Your part's DisplayFrameClosed method should not alter a part's stored list of display frames; it reflects only the deletion of the currently instantiated frame object. By contrast, OpenDoc calls a part's DisplayFrameRemoved method to permanently remove one of the part's display frames.

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

EXCEPTIONS

kODErrInvalidFrame
The specified frame is not a display frame of this part.

SEE ALSO
The ODPart::DisplayFrameRemoved method (page 498).
"The DisplayFrameClosed Method" on page 59 in OpenDoc Cookbook.
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Responding to Reconnected and Closed Display Frames" on page 106 in OpenDoc Programmer's Guide.
"Null Events" on page 194 in OpenDoc Programmer's Guide.
"Allocating Window Memory Efficiently" on page 225 in OpenDoc Programmer's Guide.